home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2001 May / SGI Freeware 2001 May - Disc 1.iso / dist / fw_hylafax.idb / usr / freeware / man / cat4 / pagermap.Z / pagermap
Text File  |  2000-06-09  |  4KB  |  132 lines
  1.  
  2.  
  3.  
  4. PPPPAAAAGGGGEEEERRRRMMMMAAAAPPPP((((4444FFFF))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 8888,,,, 1111999999996666))))       PPPPAAAAGGGGEEEERRRRMMMMAAAAPPPP((((4444FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      pagermap - SNPP pager identifier mapping file
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      The file eeeettttcccc////ppppaaaaggggeeeerrrrmmmmaaaapppp (by default) is used by the SNPP
  13.      support in _h_f_a_x_d(1M) to map pager identifiers specified with
  14.      the PAGE directive to IXO/TAP or SMS service providers and
  15.      optionally a Pager Identification Number (PIN).  (The
  16.      ability to specify a PIN makes it possible to define _a_l_i_a_s_e_s
  17.      for pagers.)  Note that eeeettttcccc////ppppaaaaggggeeeerrrrmmmmaaaapppp may be called a
  18.      different name; the filename is specified with the
  19.      _P_a_g_e_r_I_D_M_a_p_F_i_l_e configuration parameter read by _h_f_a_x_d(1M).
  20.  
  21.      The pagermap file is comprised of one or more lines of the
  22.      following format:
  23.  
  24.           <_p_a_t_t_e_r_n> <_d_i_a_l_s_t_r_i_n_g>[/<_p_i_n>]
  25.  
  26.      Each line specifies a <_p_a_t_t_e_r_n> that is matched against a
  27.      client-specified pager identifier string.  A pattern may be
  28.      a plain string or a POSIX 1003.2 extended regular
  29.      expression; plain strings must compare exactly while regular
  30.      expressions are unanchored and any substring match
  31.      constitutes a ``hit''.  Regular expressions are
  32.      distinguished from plain strings by the presence of one or
  33.      more of the magic characters ``[]*.^$-+{}()''.  The
  34.      <_d_i_a_l_s_t_r_i_n_g> identifies the IXO/TAP or SMS service provider
  35.      to contact for delivery or, if <_d_i_a_l_s_t_r_i_n_g> is the string
  36.      ``reject'' (case insensitive) then the pager identifier is
  37.      rejected.  If the optional <_p_i_n> is specified then it used
  38.      to deliver the page instead of the client-specified
  39.      identifier.
  40.  
  41.      If the matching expression is a regular expression the
  42.      optional <_p_i_n> may reference the entire string matched by
  43.      the regular expression with the ``&'' character.  Substrings
  44.      matched with the ``(...)'' constructs may be referenced by
  45.      using ``\_n'' where _n is a single numeric digit between 1 and
  46.      9 that refers to the _n-th matched substring; c.f.
  47.      _r_e__f_o_r_m_a_t(7), _s_e_d(1), etc.
  48.  
  49.      _h_f_a_x_d processes lines in the mapping file sequentially; the
  50.      first line with a pattern that matches the pager identifier
  51.      is used to deliver or reject the page.  Lines that begin
  52.      with a ``#'' are treated as comments and discarded.  Leading
  53.      whitespace on a line is also ignored.
  54.  
  55. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  56.      The following defines an alias for ``sam'', submits all
  57.      destinations with a leading ``Sky'' to a particular IXO/TAP
  58.      service provider, and otherwise rejects the pager ID.  (Note
  59.      that using alphabetics in dial strings requires a dialstring
  60.  
  61.  
  62.  
  63. Page 1                                          (printed 3/21/00)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPAAAAGGGGEEEERRRRMMMMAAAAPPPP((((4444FFFF))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 8888,,,, 1111999999996666))))       PPPPAAAAGGGGEEEERRRRMMMMAAAAPPPP((((4444FFFF))))
  71.  
  72.  
  73.  
  74.      rules file that understands how to map alphabetics to key
  75.      codes-or one that passes them through verbatim.)
  76.           # a simple mapping example
  77.           sam        5551212/99
  78.           Sky(.*)    1800SkyTel/\1
  79.           .*         reject
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      _h_f_a_x_d(1M), _h_y_l_a_f_a_x(4F)
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128. Page 2                                          (printed 3/21/00)
  129.  
  130.  
  131.  
  132.